home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / comm / yrndl140.zip / readme.1st < prev    next >
Text File  |  1996-09-24  |  9KB  |  200 lines
  1. README.1ST        22 Sep 1996        (from YRNDL140.ZIP)
  2. (c) 1996 by Jerry Levy        Marblehead, MA USA
  3. jlevy@ibm.net
  4.  
  5. README.1ST is a shortened version of YD.DOC.  YD.DOC is the
  6. documentation file accompanying YARNDIAL in YRNDL140.ZIP.
  7. Any comments, problems, bugs, irregularities or inconsistencies
  8. in operation, and suggestions should be sent to me at
  9. jlevy@ibm.net.  I will try to respond to every one.
  10.  
  11. YARNDIAL v. 1.40 is the full release version.
  12. Version number of installer (YDINSTL.CMD) is also set to 1.40.
  13.  
  14. No significant changes were made to YD.DOC in going from v.
  15. 1.34 to 1.40.  (Some sections were significantly upgraded in
  16. going from 1.3 to 1.34).
  17.  
  18. YARNDIAL.CMD is a menu-driven front end for C.T. Huang's 
  19. OS/2 Souper and Yarn off-line News and Mail reader programs.  
  20. YARNDIAL is a ReXX utility running under OS/2 Warp.  It is 
  21. designed to automate the steps needed to retrieve and send news 
  22. articles and mail and while doing so to provide a more versatile, 
  23. friendlier interface for users than could be accomplished using 
  24. ordinary batch files.
  25.  
  26. IN-JOY ALERT
  27. If you use the IN-JOY dialer, read over Section 16.00 very 
  28. carefully.  Give serious thought to setting a routing interface 
  29. name in  each host setup that is unique and different from all 
  30. other interface names used by IN-JOY or your other dialers (if you 
  31. use others).  This interface name is set in an options page for 
  32. PPP and no doubt will be equally configurable in a corresponding 
  33. SLIP options page when SLIP is supported by IN-JOY.  YARNDIAL
  34. will use this interface name you assign to positively correlate an 
  35. existing connection to the YARNDIAL installation when YARNDIAL 
  36. starts up.  It can only do this competently if you use unique 
  37. interface names, different for all connections and providers.
  38.  
  39. A fix is now implemented that addresses the IN-JOY problem where a 
  40. phantom router interface is sometimes left standing when phone 
  41. connection and connection to the router (i.e., to your Internet 
  42. Service Provider) have been terminated.  INTERFACE_REMOVALE in 
  43. the YD_PARMS.DAT file may be edited to enable the fix.  Options 
  44. are discussed in Section 16.00 and again summarized in the 
  45. YD_PARMS.DAT file created upon installation of YARNDIAL.  Default 
  46. is INTERFACE_REMOVAL=0 (does not enable a corrective action).
  47.  
  48. If INTERFACE_REMOVAL is set equal to 1 or 2 (refer section 16.00),
  49. and a routing wass left up when YARNDIAL exits, it is removed and a
  50. message is returned indicating deletion of the routing, with indication
  51. of the destination and router addresses.
  52.  
  53.  
  54. YARNDIAL and its installer (YDINSTL.CMD) should work with any
  55. version of OS/2 Warp (3.0).  Beta testers have confirmed that fixes
  56. applied to YARNDIAL v. 1.32(beta) and beyond permit it to work with
  57. the OS/2 Merlin beta.
  58.  
  59. ReXX must be installed for YARNDIAL and its installer to run.
  60.  
  61. Yarn and Souper must also be correctly installed and
  62. functioning (the true test of "correctly installed").
  63. YARNDIAL only functions as a front end and control panel for
  64. Souper and its interfaces with Yarn, and is not a substitute.
  65.  
  66. YARNDIAL's opening menu allows you seven choices:
  67.  
  68.    MAIN SELECTION MENU
  69.    1  Only import Mail
  70.    2  Only import News Articles
  71.    3  Only import, but both Mail AND News
  72.    4  Only export (send Mail, Posts, Replies, and Follow-ups)
  73.    5  Everything: Get mail and news AND send Posts, Replies,
  74.       and Follow-ups
  75.    6  Complete an interrupted importation of mail/news
  76.       or rebuild a corrupted YARN history file
  77.    7  Souper options:  one-time-only changes in how souper
  78.       runs:
  79.          Catchup on News
  80.          Maximum News Packet Size
  81.          Do not retrieve newsgroup articles longer than set
  82.            number of lines
  83.          Read-only for Mail: Don't empty POP3 mailbox
  84.    Press:
  85.        1 2 3 4 5 6 7   Executes functions as shown; goes
  86.                          off-line when done
  87.    or  ! @ # $ % ^ &   Same functions; connection remains up   
  88.    To exit now and close connection: Escape key
  89.    To exit YarnDial, but leave any existing connection up: CTRL-Q
  90.    Enter Selection:
  91.  
  92. Note: The ! @ # $ % ^ & choices represent shift-1, shift-2, 
  93. through shift-7 on a US-English keyboard.  Those alternates may be
  94. changed to suit your own keyboard.
  95.  
  96. INSTALLATION FOR THE IMPATIENT USER (ASSUMES YARN AND 
  97. SOUPER ARE INSTALLED AND THEY WORK)
  98.     1.10   First unzip YRNDL134.ZIP archive into a temporary 
  99. folder.  You have probably done that if you are reading this.
  100.  
  101. Files in the YRNDL134.ZIP archive are
  102.         FILE.DIZ        Zipfile Description
  103.         README.1ST      A lot shorter than YD.DOC
  104.         YD.DOC          This file
  105.         YDINSTL.CMD     The installer
  106.         YARNDIAL.CMD        
  107.         GO.EXE          From GO_15.ZIP, needed by YARNDIAL
  108.         GO_15.ZIP       Please open at your leisure, read         
  109.                          the documentation and send Carsten         
  110.                          his postcard.
  111.         Also an \ICONS\ subdirectory containing all of the icons 
  112.           needed
  113.  
  114. If you unzipped YRNDL134.ZIP with PkZip without using the -d 
  115. option, you will not have a subdirectory named ICONS.  That 
  116. will not interfere with installation.  YDINSTL will manage 
  117. to find the icons.
  118.  
  119.        1.20   If you are using the IBM/Advantis IAK Dialer
  120. proceed directly to the next step (1.30).
  121.  
  122. If you are using either SLIPPM (the IBM Dial-Other-Internet-
  123. Providers utility) or the ILINK/2 dialer, you MUST set up
  124. SLIPPM and verify it can connect to your provider successfully
  125. before you run YDINSTL.CMD to install YARNDIAL.
  126.  
  127. If you are using either the IN-JOY dialer, or a SLIP.EXE or
  128. PPP.EXE dialup string to connect, you SHOULD set up
  129. SLIPPM and verify it can conect to your provider successfully
  130. before you run YDINSTL.CMD to install YARNDIAL.  This is
  131. because the YARNDIAL installer (YDINSTL.CMD) can extract
  132. parameters from the TCPOS2.INI file used to store SLIPPM
  133. setup information. 
  134.  
  135. In setting up SLIPPM, you MUST fill in the names of your news
  136. server, your mail gateway (i.e., your SMTP server), your POP
  137. mail server, your pop login ID, and your pop password.  This is 
  138. not required for SLIPPM operation but the YARNDIAL installer 
  139. (YDINSTL.CMD) needs them and will automatically incorporate those 
  140. parameters into YARNDIAL's data file. 
  141.  
  142.        1.30   Double-click on YDINSTL.CMD and follow the 
  143. instructions in screen prompts.
  144.  
  145.  
  146. YD.DOC FILE: CONTENTS
  147.  1.00  Installation For The Impatient User (Assumes Yarn And 
  148.         Souper Are Installed And They Work
  149.  2.00  What Is Yarndial?
  150.  3.00  Key Features
  151.  4.00  Copyright Notice And Disclaimers
  152.  5.00  Passwords - Disclaimer
  153.  6.00  How Does The Installer Work?
  154.  7.00  Example: Setting Up For Two Users (My Installation)
  155.  8.00  What Does YDINSTL.CMD Do?
  156.  9.00  .CMD Files Created - Meaning Of Customization 
  157. 10.00  Recreating Objects (Running OBJECTS.CMD - A Peculiarity)
  158. 11.00  Warp, Souper, Yarn: Versions Tested
  159. 12.00  You Have Not Installed Yarn And Souper Yet?
  160. 13.00  History
  161. 14.00  Should You Upgrade Anything Before You Install?
  162.         14.10   Souper
  163.         14.20   IBM/Advantis IAK Dialer
  164.         14.30   SLIPPM.EXE (Dial-Other-Internet-Providers Utility 
  165.                  and SLIP Upgrades
  166. 15.00  Before You Run YDINSTL.CMD
  167. 16.00  Notes On Using the IN-JOY Dialer
  168. 17.00  About The Fix-Interrupted-Import Option On The Main
  169.         YARNDIAL Menu
  170. 18.00  Souper Command-Line Options
  171. 19.00  Issues That May Come Up During Or After Install
  172. 20.00  Manual Install
  173. 21.00  Manual Install: The Password Problem
  174. 22.00  Connection_Type: The Different Choices
  175. 23.00  More About Dialup_String: A Programming Note
  176. 24.00  Zip And UnZip Files
  177. 25.00  Compression Executables: OS/2 Versus MS-DOS 
  178. 26.00  Some Other Breed Of Compression Utilities
  179. 27.00  Files For Setting Up Yarn And Souper From Scratch
  180. 28.00  Install EMXRT, METAMAIL, MIME64 (recommended)
  181.         28.10 EMXRT09B (optional)
  182.         28.20 MIME64 (optional) 
  183.         28.30 METAMAIL (optional)
  184.            28.31  Metamail Tricks
  185.            28.32  Doing Attachments Under Yarn, Metamail 
  186.                    Operation, Decoding Multipart Messages, and 
  187.                    Handling Non-Conforming MIME Attachments
  188.               28.321  Doing Attachments Under Yarn, etc.
  189.               28.322  Decoding Non-Conforming Mime Attachments
  190.               28.323  Decoding MIME With MIME64.EXE
  191.               28.324  Content-type Editing:  MIME Associations
  192. 29.00  Step-By-Step Installation Of Yarn and Souper
  193. 30.00  Note About Adding Newsgroups
  194. 31.00  Setting Up And Installing For Multiple Users
  195. 32.00  Connection Killed Or Not When YARNDIAL Ends
  196. 33.00  Where To Get Software And Helpful Documentation
  197. 34.00  Bugs and Error-Trapping
  198.  
  199.  
  200. Marblehead, MA    JL